home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Online / Epic4 / share / epic / help / 5_programming / on / dcc_connect < prev    next >
Encoding:
Text File  |  2001-03-21  |  1.1 KB  |  34 lines

  1. Synopsis:
  2.    on [<modes>]dcc_connect [<serial#>] [-|^]<match> { <action> }
  3.  
  4. Description:
  5.    This hook is triggered whenever the client successfully establishes a
  6.    DCC connection with another client.  Currently, this is either a CHAT
  7.    or a SEND connection.
  8.  
  9. Parameters:
  10.    $0    nickname of remote client
  11.    $1    type of DCC connection
  12.    $2    ip address of remote client
  13.    $3    port on the ip address the client is connected to
  14.    $4    file name (SEND only)
  15.    $5    file size (SEND only)
  16.  
  17. Examples:
  18.    To customize the connection message:
  19.       on ^dcc_connect "*" {
  20.          echo *** DCC $1 connection with $0[$2:$3] established
  21.          if ( [$1] == [send] ) echo *** Transferring $4 \($5 bytes\)
  22.       }
  23.  
  24. See Also:
  25.    dcc(1); on(5) dcc_lost, dcc_request
  26.  
  27. Other Notes:
  28.    Note that establishing a DCC connection does not involve the irc network.
  29.    Thus, the $userhost() function will not work inside this hook.
  30.  
  31.    For a DCC SEND connection, this will be hooked twice. Once with $1 being
  32.    SEND, and again being GET. This is for compatibility with bitchx.
  33.  
  34.